home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 051-075 / disk_067 / comm / comm.doc < prev    next >
Text File  |  1992-05-06  |  36KB  |  769 lines

  1.                              Comm 1.33
  2.                  A terminal program for the AMIGA
  3.  
  4.          Send suggestions for improvement or bug reports to:
  5.  
  6.             DJJAMES     Plink
  7.             70320,124   CIS
  8.  
  9. ---------------------------------------------
  10. Features:
  11.        ASCII send and capture modes.
  12.        XMODEM send/receive with checksum and CRC modes and AUTOCHOP on
  13.          receive files.
  14.        Windowed XMODEM up and downloading.
  15.        Screen I/O greater than 2400 baud.
  16.        Baud rates up to 19200 baud supported.
  17.  
  18.        20 keyboard macros using Function keys.
  19.        44 entry phone library with support for non-Hayes type modems
  20.        Hot Key dialing for 10 phone numbers.
  21.        An alternate long distance service number (MCI, SPRINT etc)
  22.          can be used.
  23.  
  24.        Split screen mode for conferencing.
  25.        Interlaced screen optional.
  26.        Serial port parity, bit length and stop bit control also
  27.          Full/Half duplex, send line break and control of End Of Line
  28.          characters
  29.  
  30.        DOS 1.2 support.
  31.        Menu driven.
  32.  
  33. ---------------------------------------------
  34. Preparation:
  35.  
  36.       Create a phone library file (if desired) named Comm.Phone.
  37.       Create a keyboard macro file (if desired) named Comm.Keys.
  38.  
  39.       From CLI type:    comm [ filename ] [-i]
  40.          where filename is the name of a phone number library.  If not
  41.          given, the default filename COMM.PHONE will be used.
  42.          if -i is given, Comm will use an interlaced screen.
  43.  
  44.       From WorkBench, just click on the COMM icon.
  45.  
  46.       NOTE:  WorkBench users can specify the default Phone library, Key
  47.       Macro files and interlaced mode by using the TOOL TYPE entry in the
  48.       ICON structure.
  49.       To enter these defaults, click once on the Comm icon and select
  50.       the INFO entry from the WORKBENCH menu.  When the INFO window opens,
  51.       you will see a STACK gadget and a TOOL TYPES gadget.  Click in the
  52.       stack gadget and enter a value of 8000.
  53.  
  54.       Because of a bug in DOS 1.1 Workbench, you will have to follow
  55.       these instructions to enter the strings.  This bug has been fixed
  56.       in DOS 1.2.
  57.  
  58.       To enter the phone library:
  59.         Select the ADD gadget next to the TOOL TYPES gadget.  Then click
  60.         in the TOOLTYPES gadget and type PHONE=filename
  61.         ( where filename is the name of the default phone directory to be
  62.         associated with this icon ) and hit return.
  63.         Select ADD again, click in the box and hit return. (DOS 1.1 only)
  64.  
  65.       To enter the key macro file:
  66.         Select the ADD gadget next to the TOOL TYPES gadget.  Then click
  67.         in the TOOLTYPES gadget and type KEYS=filename
  68.         ( where filename is the name of the default key macro file to be
  69.         associated with this icon ) and hit return.
  70.         Select ADD again, click in the box and hit return. (DOS 1.1 only)
  71.  
  72.       To enter the interlace option:
  73.         Select the ADD gadget next to the TOOL TYPES gadget.  Then click
  74.         in the TOOLTYPES gadget and type INTERLACE=ON
  75.         Select ADD again, click in the box and hit return. (DOS 1.1 only)
  76.  
  77.       Then select the SAVE option in the INFO window.  The defaults will
  78.       be active whenever you select Comm via this icon.
  79.  
  80. ---------------------------------------------
  81. MENUS:
  82.  
  83.    When in Comm, the following menu topics are available:
  84.  
  85.    1) FILE -- This is the file transfer menu.  From here you can select
  86.       the name of a file to be transfered, the direction of the transfer
  87.       ( to your disk or from you disk ) and whether an error detecting
  88.       protocol ( XMODEM ) will be used.
  89.  
  90.       When one of these entries is selected, the INPUT window will appear
  91.       in the upper left corner of the screen.  Move the pointer to the
  92.       long string gadget in the center of the window and enter the name
  93.       of the file to be transfered.  Hitting RETURN or clicking on the
  94.       OK gadget will start the transfer.  See the section on INPUT window
  95.       for more information on the gadgets in this window.
  96.  
  97.       The sub-entries of the FILE menu are:
  98.  
  99.        Start ASCII Capture
  100.                  All data received from the serial port is also saved into
  101.                the named file.  The text is buffered and written to the disk
  102.                in 8K blocks.
  103.  
  104.                  When this mode is selected, the text in the MENU entry is
  105.                changed to "Stop ASCII Capture".  Selecting this entry will
  106.                flush the data buffer to the disk and close the file.
  107.  
  108.                  Once the capture mode has been selected and a filename has
  109.                been entered, you can use the LEFT AMIGA C key sequence to
  110.                suspend or enable (toggle) the capturing of data.  Capturing
  111.                is enabled when the file is first selected.  Suspending the
  112.                data capture does not close the file, it simple does not
  113.                buffer the text.  When capturing is enabled, the word "ON"
  114.                will be visible in the lower right hand corner of the screen.
  115.                When capturing is suspended, this will change to "SUS".
  116.  
  117.                  When entering a filename for data capture, Comm will check
  118.                to see if this file already exists.  If it does, a requester
  119.                will appear advising you of that fact.  You have the option
  120.                to CONTINUE using the filename entered or CANCEL and enter
  121.                another filename.  If you choose to CONTINUE, you will be
  122.                presented with another requester giving you the choice to
  123.                APPEND data to the existing file or DELETE the existing data
  124.                and start a fresh file.  Under DOS 1.2, the CONTINUE and
  125.                APPEND options can be answered with the LEFT AMIGA V key.
  126.                The CANCEL and DELETE options can be answered with the
  127.                LEFT AMIGA B key.  Of course, you can click the left mouse
  128.                button over these selections as well.
  129.  
  130.                  If you hit Left Amiga C (toggle capture) without first
  131.                opening a capture file, a default file "RAM:Capture.txt"
  132.                will be opened for you.  You are not given the above options
  133.                to CANCEL, APPEND or DELETE when this short cut is used.
  134.                The old file (if it exists) is always deleted and a new
  135.                file is created.
  136.  
  137.                  The HELP key can also be used to view the current state of
  138.                the capture mode.
  139.  
  140.             See also:  HOT KEYS, HELP KEY
  141.  
  142.        Start ASCII Send
  143.                  The named file will be read and sent to the serial port.
  144.                If the file does not exist, a warning message will be
  145.                printed.
  146.  
  147.                  When this mode is selected, the text in the MENU entry is
  148.                changed to "Stop ASCII Send".  Selecting this entry will
  149.                stop the transfer and close the disk file.
  150.  
  151.                  You can select a time to delay after transmitting each
  152.                character by using the slider gadget in the INPUT windows
  153.                drag bar.
  154.                With the slider in the (default) far left position, there is
  155.                no delay.  The far right position will produce about 3/4
  156.                second delay after transmitting a character.  Clicking within
  157.                the slider body, will cause the knob to move in about .1
  158.                second intervals.
  159.  
  160.             See also:   INPUT WINDOW
  161.  
  162.        XMODEM Receive
  163.                  The named file will be created on the disk and the
  164.                XMODEM protocol will be started using the error checking
  165.                method (CRC or Checksum) selected in the MODE menu.
  166.  
  167.                  If the specified file already exists, a requester will
  168.                appear giving you the option to CONTINUE or CANCEL the use
  169.                of that filename.  Selecting CONTINUE will overwrite the
  170.                old existing file with the new one.  Selecting CANCEL will
  171.                bring up the INPUT WINDOW allowing you to enter another
  172.                file name.  Under DOS 1.2, LEFT AMIGA V is the same as
  173.                CONTINUE while LEFT AMIGA B is the same as CANCEL.
  174.  
  175.                  The transfer can be aborted by hitting the ESC key.
  176.  
  177.                  The serial port parameters will be saved and changed to
  178.                8 bits, no parity, 1 stop bit for the XMODEM transfer.
  179.                Upon completion, the old settings will be restored.
  180.  
  181.                  The status line (bottom of screen) will display the name
  182.                of the file being transferred, a running total of the bytes
  183.                received, the number of NAKS and the last block to be NAKed
  184.                (in square brackets).
  185.  
  186.             See also:   MODE menu, Chop Files
  187.  
  188.        WXMODEM Receive
  189.                  The named file will be created on the disk and the
  190.                Windowed XMODEM protocol will be started.
  191.  
  192.                  If the specified file already exists, a requester will
  193.                appear giving you the option to CONTINUE or CANCEL the use
  194.                of that filename.  Selecting CONTINUE will overwrite the
  195.                old existing file with the new one.  Selecting CANCEL will
  196.                bring up the INPUT WINDOW allowing you to enter another
  197.                file name.  Under DOS 1.2, LEFT AMIGA V is the same as
  198.                CONTINUE while LEFT AMIGA B is the same as CANCEL.
  199.  
  200.                  The transfer can be aborted by hitting the ESC key.
  201.  
  202.                  The serial port parameters will be saved and changed to
  203.                8 bits, no parity, 1 stop bit for the WXMODEM transfer.
  204.                Upon completion, the old settings will be restored.
  205.  
  206.                  The status line (bottom of screen) will display the name
  207.                of the file being transferred, a running total of the bytes
  208.                received, the number of NAKS and the last block to be NAKed
  209.                (in square brackets).
  210.  
  211.                Windowed XMODEM is a recent improvement on the original
  212.                XMODEM protocol.  Not all services offer WXMODEM.
  213.  
  214.                WXMODEM can offer up to a 50% reduction in file transfer
  215.                time when used over public data networks such as Telenet
  216.                and Tymnet.
  217.  
  218.                As of this writing, the only service offering WXMODEM
  219.                transfers is the American People Link (PLINK).  They have
  220.                an active Amiga section.  800-524-0100 until 10 PM CST
  221.                for info.
  222.  
  223.        XMODEM Transmit (WXMODEM Transmit)
  224.                Use this selection for either XMODEM or WXMODEM transfers.
  225.  
  226.                  The named file will be opened on the disk and the
  227.                XMODEM (or WXMODEM) protocol will be started using the
  228.                error checking method (CRC or Checksum) selected by the
  229.                receiving end.
  230.  
  231.                  If the specified file does not exist, a requester will
  232.                appear advising you of that fact.  You only have the option
  233.                to CONTINUE, which will bring up the INPUT WINDOW allowing
  234.                you to re-enter the filename or CANCEL the upload.
  235.  
  236.                  The transfer can be aborted by hitting the ESC key.
  237.  
  238.                  The serial port parameters will be saved and changed to
  239.                8 bits, no parity, 1 stop bit for the XMODEM transfer.
  240.                Upon completion, the old settings will be restored.
  241.  
  242.                  The status line (bottom of screen) will display the name
  243.                of the file being transferred, a running total of the bytes
  244.                received, the number of NAKS and the last block to be NAKed
  245.                (in square brackets).
  246.  
  247.                Windowed XMODEM is a recent improvement on the original
  248.                XMODEM protocol.  Not all services offer WXMODEM.
  249.  
  250.                WXMODEM can offer up to a 50% reduction in file transfer
  251.                time when used over public data networks such as Telenet
  252.                and Tymnet.
  253.  
  254.                As of this writing, the only service offering WXMODEM
  255.                transfers is the American People Link (PLINK).  They have
  256.                an active Amiga section.  800-524-0100 until 10 PM CST
  257.                for info.
  258.  
  259.             See also:   XMODEM Text Send
  260.  
  261.        XMODEM Text Send
  262.                  Read the text for XMODEM transmit above.  Use this option
  263.                for text tranfers using the WXMODEM protocol as well.
  264.  
  265.                  In addition to the above text, when this entry is selected,
  266.                any LF characters in the transmitted file will be converted
  267.                to CR characters.  This option should be selected when
  268.                sending an AMIGA created file to another type of machine.
  269.  
  270.                  Failure to use this option when sending a text file may
  271.                produce an unusable file on the remote machine.
  272.  
  273.             See also:   XMODEM Transmit
  274.  
  275.        Quit Comm
  276.                  Selecting this entry will close all open files and
  277.                windows and exit back to the operating system.
  278.  
  279.                  The same effect can be achieved by hitting the close
  280.                gadget in the TRANSMIT window.
  281.  
  282.             See also:   Window gadgets
  283.  
  284. ---------------------------------------------
  285.    2) System
  286.       Split Screen
  287.                  Select 'Split Screen' from the system menu.  The screen
  288.                will divide into two windows, a small one ( 4 lines ) for
  289.                your typed characters and a larger one ( 19 lines ) for
  290.                characters received from the modem.
  291.                  You should select the half-duplex mode on the host system
  292.                to prevent your typed characters from being echoed back into
  293.                the receive window.
  294.                  To exit the split screen mode, either use the RX window
  295.                close gadget or select 'Split Screen' from the system menu
  296.                again.
  297.  
  298.                  Using the close gadget in the TX window will exit Comm.
  299.  
  300.                Split screen mode may not operate in interlaced mode on a
  301.                512K or less machine due to lack of memory.
  302.  
  303.         CAUTION: If you login to a system while in the split screen mode
  304.                your password will be echoed in the TX window.  It's best
  305.                to login in the single screen mode.
  306.  
  307.       View Transfers
  308.  
  309.                   Select the 'View transfer' mode from the system menu.
  310.                 This option will output the file data to a view window
  311.                 while transfering data.  It is wise only to view files
  312.                 you know to be ASCII because binary files will look like
  313.                 Greek.  No harm will be done, but it is distracting.
  314.  
  315.       Chop Files
  316.  
  317.                   XMODEM file transfers will increase the size of a file
  318.                 to the next largest multiple of 128 bytes.  The CHOP FILES
  319.                 option -- when checked -- will remove the padding on the
  320.                 end of the file.  This is usually desired and always
  321.                 required when transfering executable binary files.  CHOPing
  322.                 files is the default mode.
  323.  
  324.                NOTE:  It is not desireable to CHOP an ARC file.  Since I
  325.                always forget to turn off the CHOP mode for ARC files, Comm
  326.                will check the file extent of XMODEM receive files looking
  327.                for .ARC or .arc   If found it will temporarily disable
  328.                CHOPing for this file, and restore the state of the CHOP
  329.                flag after the file has been received.
  330.  
  331.       End of Line
  332.                 You can select how End of Line characters are handled on the
  333.               screen and when sent out the serial port.  By default, EOL is
  334.               just a RETURN character, but you can change this to  RETURN
  335.               and LINEFEED pairs.
  336.  
  337.                 Use this option if all text seems to be printed on one line.
  338.       Key Macro
  339.  
  340.                 This item allows Loading or Saving the Key Macro file.
  341.  
  342.                 You can add/change keyboard macros using the "Edit Key Macro"
  343.               selection in the SYSTEM menu.  When the ASCII window opens on
  344.               this option, click the mouse in the requester text input box
  345.               and enter the new keyboard macro in the same format as the
  346.               key macro file:
  347.  
  348.                        f9This is a new macro\r
  349.  
  350.               Enter the text and hit return (or select the OK gadget ) to
  351.               install the new macro.
  352.  
  353.       Phone Dir
  354.                 This entry allows loading or editing a phone library.
  355.               The EDIT option will bring up the Amiga screen editor ED with
  356.               the contents of the phone library file ready to be changed.
  357.               Exit ED as usual with  ESC X to return to Comm.
  358.  
  359.               NOTE:  The EDIT option can only be used if Comm has been
  360.               invoked from the CLI.  If invoked from WorkBench, this option
  361.               will be disabled.  ED must be in the C: directory.
  362.  
  363.                The SAVE option is not implimented.
  364.  
  365.  
  366. ---------------------------------------------
  367.    3) Mode -- this menu selects the type of error ckecking to be used with
  368.             XMODEM file downloads.
  369.  
  370.       Checksum
  371.                  The original Christensen protocol used an 8 bit checksum
  372.                for error checking.  It is about 97% effective in catching
  373.                errors.  All implimentations of XMODEM can use the
  374.                checksum method.  When in doubt, select this method.
  375.  
  376.       CRC
  377.                  A later addition to the protocol was the 16 bit (two byte)
  378.                Cyclic Redundancy Check ( CRC ) which is about 99.997%
  379.                effective in detecting errors.  Not all implimentations of
  380.                XMODEM use the CRC method.  If you select this mode and the
  381.                sending computer can not transmit CRC mode, Comm will detect
  382.                this fact after 5 timeouts ( about 50 seconds ) and switch
  383.                to the Checksum method.
  384.  
  385. ---------------------------------------------
  386.    4) Serial -- serial device parameters are changed here.
  387.  
  388.       Baud
  389.                  Baud rates from 300 to 19200 baud can be selected.
  390.  
  391.                Comm will start out with the baud rate selected by the user
  392.                in Preferences.
  393.  
  394.                  Note that this selects the serial speed of the port, the
  395.                actual data throughput rate depends on whether the capture
  396.                buffer is active, the printer capture is selected and the
  397.                speed of screen I/O.  With no printer or file capture, the
  398.                throughput rate depends on the screen I/O speed.  This will
  399.                be greater than 2400 baud but less than 4800 baud in this
  400.                release of Comm.  This means, that if you select a baud
  401.                rate of greater than 2400 baud, you will drop characters
  402.                unless the Automatic XON feature has been selected from
  403.                the SERIAL menu.
  404.  
  405.                  This entry can be overridden by the default baud rate
  406.                field in the phone library.
  407.  
  408.             See also:   XON / XOFF
  409.  
  410.       Parity
  411.                  Selects ODD, EVEN or NO parity.  Default is NO parity.
  412.  
  413.                  Note that during XMODEM transfers, serial port parity is
  414.                set to NO parity and restored to the previous value on
  415.                completion.
  416.  
  417.                  Most computer systems today will operate with NO parity.
  418.  
  419.       Data Length
  420.                  Selects the length of a data word as 7 or 8 bits.
  421.                Default is 8 bits.
  422.  
  423.                  Note that during XMODEM transfers, serial port data length
  424.                is set to 8 bits and restored to the previous value on
  425.                completion.
  426.  
  427.                  Most computer systems today will operate with 8 bits.
  428.  
  429.       Stop Bits
  430.                  Selects the number of stop bits transmitted as 1 or 2 bits.
  431.                Default is 2 bits.
  432.  
  433.                  Note that during XMODEM transfers, serial port stop bit
  434.                length is set to 1 bit and restored to the previous value on
  435.                completion.
  436.  
  437.                  The Amiga hardware does not allow 2 stop bits to be used
  438.                with an 8 bit data word length.
  439.  
  440.                  Most computer systems today will operate with 1 stop bit.
  441.  
  442.       Duplex
  443.                  Selects whether Comm or the remote system echo your key
  444.                strokes to the screen.  Defaults to FULL duplex.
  445.  
  446.                  Select FULL duplex when the remote machine will echo your
  447.                key strokes.
  448.  
  449.                  Select HALF duplex when the remote system does not echo
  450.                your key strokes.  That is when the remote system seems to
  451.                be responding to your commands, but you can't see what you
  452.                type.
  453.  
  454.       XON / XOFF
  455.                  Enables or disables the serial driver check for XON / XOFF
  456.                flow control characters.  Defaults to OFF.
  457.  
  458.                  Select TURNED OFF when you do not wish to use this type of
  459.                flow control.
  460.  
  461.                  Select AUTOMATIC when you wish the driver to use this type
  462.                of flow control.  Normally used at baud rates greater than
  463.                2400 baud to prevent dropped characters.
  464.  
  465.                NOTE:  In some cases, when the AUTOMATIC mode is selected,
  466.                Comm may receive an XOFF character ( noise or otherwise )
  467.                and appear to be hung -- that is, no characters appear on the
  468.                screen yet the menus still function.  Whenever Comm appears
  469.                to be hung, typing a CONTROL Q will re-start the serial line.
  470.                If the problem was due to an XOFF character received, this
  471.                will restore everything to normal.
  472.  
  473.                ALSO NOTE:  A number of people have reported that Comm gets
  474.                hung when they use Telenet, have AUTOMATIC selected and
  475.                type keys rapidly.  This seems to be due to Telenet sending
  476.                XOFF characters.  It may be wise to select TURNED OFF when
  477.                using Telenet.
  478.  
  479.       Send Break
  480.                Sends a 250 ms break signal.  Right Amiga B will also send
  481.                the break character.
  482.  
  483. ---------------------------------------------
  484.    5) Phone
  485.          Dial a phone number or hang up the phone.
  486.  
  487.             If a phone library of the proper format was loaded when Comm
  488.           started, you will see the NAME fields of the phone entries in this
  489.           menu.  Simply move the select box over the desired name to be
  490.           called and release.  Comm will then compose a dialing entry
  491.           consisting of:
  492.     DIAL STRING+ALTERNATE LONG DISTANCE NUMBER+PHONE NUMBER+DIAL TERMINATOR
  493.           and send this to the modem.
  494.  
  495.             You may also dial any of the first 10 numbers in the phone
  496.           directory by using the RIGHT AMIGA # key sequence, where # is
  497.           one of the keys 1,2,3,4,5,6,7,8,9,0.
  498.  
  499.             The dial string fields default to HAYES types, but can be changed
  500.           by an entry in the phone library.
  501.  
  502.       Hang up
  503.                  Selecting this entry will send the HANGUP command string
  504.                to the modem.  This string defaults to a HAYES compatable
  505.                string, but can be changed by an entry in the phone library.
  506.                You may also use RIGHT AMIGA H to select this option.
  507.  
  508.       Alt Service
  509.                  This entry will prepend an alternate long distance dial
  510.                code to the phone number you select.  Useful for selecting
  511.                MCI or SPRINT or any of the dozen other phone services.
  512.  
  513.                  The dial string is taken from a phone library entry.
  514.  
  515.                  You may also use RIGHT AMIGA A to select this option.
  516. ---------------------------------------------
  517.    Hot Keys
  518.            Left Amiga C -- will open/close the capture buffer.  The capture
  519.                mode must first be selected through the FILE menu.  Then use
  520.                the hot key to enable or disable text capturing into the
  521.                buffer.  Capturing is enabled when first selected.
  522.                Use the HELP key to see the state of the capture mode.
  523.                  If you hit Left Amiga C without first opening a capture
  524.                file, a default file "RAM:Capture.txt" will be opened for
  525.                you.
  526.  
  527.             Left Amiga P -- toggles the printer ON/OFF.  When ON, text
  528.                received from the serial port will also go to the printer
  529.                via the PRT: device.
  530.  
  531.             Right Amiga # -- where # is one of the keys 1,2,3,4,5,6,7,8,9,0
  532.                This sequence will dial one of the first 10 entries in the
  533.                phone library.
  534.  
  535.             Right Amiga H -- Hang up the phone.
  536.  
  537.             Right Amiga A -- select the Alternte Long Distance dialing
  538.                service.  This is identical to using the mouse to select
  539.                the Alt. Service option in the PHONE menu.
  540.  
  541. ---------------------------------------------
  542.    Help Key
  543.             The HELP key can be used to view the KEYBOARD MACROS that have
  544.           been defined, the state of the printer and capture buffer toggles
  545.           and the version of Comm.  You will also see the amount of
  546.           available memory.
  547.  
  548. ---------------------------------------------
  549.    Input Window
  550.             When a menu item is selected that requires a filename input,
  551.           the INPUT WINDOW will appear in the upper left hand corner of
  552.           the screen.  This window will contain an informative message
  553.           relating to the operation selected, two string gadgets for text
  554.           input and two select gadgets.
  555.  
  556.             The large string gadget in the center is used for entering
  557.           filenames.  Position the pointer inside the blue select box
  558.           and click the left mouse button to activate this gadget.  When
  559.           the cursor appears inside the gagdet, enter the filename desired.
  560.  
  561.             Hitting return will enter the filename and remove the INPUT
  562.           WINDOW.  You can also click the left mouse button over the text
  563.           in the lower left hand corner to complete the operation.
  564.  
  565.             Selecting CANCEL will abort the operation.
  566.  
  567.             The smaller string gadget can be used to enter a default
  568.           directory string.  Whatever is put in here will be prepended to
  569.           the filename entered in the string gadget.  If you were to put
  570.             DF1:NewFiles/  in the gadget, all up/down loads will be from the
  571.           NewFiles directory on DF1:   If you enter a filename with an
  572.           imbedded colon, the default is over ridden.  That means, with the
  573.           above default, you could get a file from RAM: by entering
  574.             RAM:SomeFile for a filename.
  575.  
  576.            Under DOS 1.2, the INPUT WINDOW string gadgets will be active
  577.          when the INPUT WINDOW opens.  You will not have to click in them
  578.          to activate them.  The cursor will appear in the gadget that is
  579.          active and awaiting input.
  580.  
  581.    *** NOTE ***
  582.            Under DOS 1.2, the default directory gadget will be active when
  583.          the INPUT WINDOW first opens.  If you do not wish to change the
  584.          string in this gadget, simply hit the RETURN key.  This will
  585.          deactivate the default directory gadget (keeping the old data)
  586.          and activate the filename string gadget.  Enter the filename
  587.          desired and the desired operation will commence.
  588.  
  589. ---------------------------------------------
  590.    Window Gadgets
  591.             The screens contain hidden gadgets for closing and depth
  592.           arranging the Comm screen.  The CLOSE gadget is in the upper
  593.           left hand corner.  The depth gadgets are in the upper right
  594.           hand corner.
  595.  
  596.             The operation of the depth gadgets differs slightly
  597.           from what you may expect.  The left hand depth gadget will send
  598.           the Comm screen to the back to allow access to the WorkBench
  599.           or other screen.  The right hand depth gadget will bring the
  600.           View Window to the front -- if it was pushed to the rear.
  601.  
  602.             The close gadget also operates differently depending upon
  603.           which mode Comm is in.  In the single screen mode, the close
  604.           gadget can be used to EXIT Comm.
  605.  
  606.             In the split screen mode, there is a close gadget in the
  607.           corner of both screens.  The gadget in the large window will
  608.           cancel the split screen mode.  The gadget in the small screen
  609.           will exit Comm.
  610.  
  611. ---------------------------------------------
  612. Phone library:       (sample phone library is at end of this file)
  613.       When loaded, Comm looks first on the default drive for a file called
  614.       comm.phone.  If not found, it then looks on the SYS: device for this
  615.       file.  If not found, Comm will operate with out the phone library
  616.       but you will not have the auto dial options.
  617.  
  618.       If called from the CLI, you can specify another file for the phone
  619.       library on the command line such as:
  620.             Comm  business.numbers
  621.  
  622.       Comm will try the above mentioned search pattern looking for the
  623.       file 'business.numbers'.
  624.  
  625.       The phone libraries are ASCII text files (created with ED) with fixed
  626.       format records as follows:
  627.  
  628.          17 characters for a BBS name           ex.  Plink
  629.          17 characters for the phone number     ex.  1-800-555-1212
  630.           9 characters for default baud rate for number
  631.          32 characters for any user comment     ex.  Tymnet, enter A
  632.  
  633.       This looks like the following:
  634. |       17       |      17        |    9   |            32                |
  635. |----- name -----|---- number ----|- baud -|--------- comment ------------|
  636. amiga talk       1,602-846-3901   1200     ???
  637. amiga/128        1,213-662-2424   1200     CA amiga and 128 stuff
  638. >                555-1212,,01234           MCI gateway and account number
  639.  
  640.  
  641.       Note that lines starting with | are ignored when the file is read in
  642.       and are used for comments.  The bars (|) also mark the field widths
  643.       for alignment purposes.
  644.  
  645.       One entry ( > in the name field ) can be an alternate long distance
  646.       service access number and account number.  When this feature is
  647.       desired the contents of the number field will be sent before the
  648.       phone number selected.
  649.  
  650.       The modem dial commands can also be specified in the phone library
  651.       using one of the following command sequences:
  652.  
  653.          <D          sets the dial PREFIX string.
  654.          <T          sets the TERMINATOR string.
  655.          <H          sets the HANGUP string.
  656.          <I          sets the initialization string
  657.          <E          sets the exit string
  658.  
  659.       These sequences must start in col. 1 and are limited to 32 characters.
  660.       Any of the KEY MACRO special symbols (such as delay, line break or
  661.       control codes) may be included in any of thses strings.
  662.  
  663.      The following are the default HAYES modem setup strings used by Comm if
  664.      not changed by the user.
  665.  
  666. <DATDT                        DIAL Prefix command   (ATDT)
  667. <T^M                          DIAL terminator       ( CR )
  668. <H\w\w+++\w\w\w\wATH^M        HANGUP command   (1 sec +++ 2 sec ATH CR)
  669. <I                            Initialization -- none
  670. <E                            Exit -- none
  671.  
  672.      The initialization string will be sent to the modem soon after Comm
  673.      opens the serial device and before keyboard input is accepted.
  674.  
  675.      The exit string is send just before the serial device is closed when
  676.      exiting Comm.
  677.  
  678. ---------------------------------------------
  679. Keyboard Macros:
  680.       On entry, Comm will look on the default drive for the file
  681.       comm.keys.  If not found it will look for SYS:comm.keys.  This
  682.       file is an ASCII file (created with ED) containing the macros to
  683.       be expanded whenever a function key is pressed.  In this release
  684.       the function keys definable are F1 through F10 and SHIFT F1 thru F10.
  685.       A sample comm.keys file follows:
  686.  
  687. f1/clubs;/sel commodore\r
  688. f2/not;for;/read new^m
  689. f3/lib;rev;qsc all\r
  690. F4/dlo;fil;xmo;\r\r
  691. S10/off
  692.  
  693.       Notice that each definition starts in column 1 with an 'f' or 's'
  694.       followed by the number of the key to be defined.  Entries beginning
  695.       with F belong to F1 thru F10, those beginning with S belong to
  696.       SHIFT F1 thru SHIFT F10.
  697.  
  698.       The body of the macro follows the number.  Do not separate the
  699.       key number from the body with spaces unless you desire spaces to be
  700.       output.  A macro definition must be contained on 1 line (127 bytes
  701.       maximum).  The macros can be defined in any order and not all keys
  702.       have to be defined.  Duplicate definitions overwrite the previous
  703.       definition, that is, only the last definition sticks. The first one
  704.       is overwritten.
  705.  
  706.       The macros can contain control characters which can be represented
  707.       in two ways -- using C slash conventions ( \n \r etc) or by using
  708.       the caret followed by a letter ( ^C  ^L etc.).  The only C types
  709.       supported in this release are \n, \r, \t, \f and \\.  Also, \n is
  710.       equivalent to \r, both meaning CR.  If you need the line feed
  711.       character, use ^J instead.
  712.  
  713.       A 500 millisecond delay can be generated by using \w.  Multiple \w's
  714.       can be used to get a longer delay.
  715.       A 250 ms LINE BREAK can be generated with the sequence \l.
  716.  
  717.       You can cause one macro to be included inside of another macro by
  718.       using the \m## option, where ## is a number from 1 to 20 - with 1
  719.       representing macro F1 and 11 and 20 representing S1 and S20.
  720.       For example:
  721.          F1 is defined as    cc   testfile\r
  722.          F2 is defined as    link testfile^M
  723.          F3 is defined as    \m1\m2run testfile\r
  724.       Pressing F3 will emit the string:
  725.          cc testfile\rlink testfile^Mrun testfile\r
  726.  
  727.       Once the comm.keys are loaded, press the HELP key to list the
  728.       macro definitions to the screen.
  729.  
  730.       Errors are detected while loading the .keys file and displayed on
  731.       the screen.
  732.  
  733. ---------------------------------------------------------------------------
  734. BUGS:
  735.          Screen sometimes displays garbage as though you were typing a
  736.          binary file.  I have seen this once or twice but not enough to
  737.          discover what may be causing the problem.
  738.  
  739.          If another program 'steals' all of the audio channels, Comm will
  740.          lose it's bell.
  741.  
  742. ----------------------------------------------------------------------------
  743.  
  744. Sample phone library:
  745.  
  746. |  The following entries are the Dial, Terminating and Hangup strings
  747. |     for a Hayes modem.  These can be changed for other modem types.
  748. <DATDT
  749. <T^M
  750. <H\w\w+++\w\w\w\wATH^M
  751. |       17       |      17        |    9   |            32                |
  752. |----- name -----|---- number ----|- baud -|--------- comment ------------|
  753. amiga talk       1,602-846-3901   1200
  754. amiga/128        1,213-662-2424   1200     CA
  755. amuse            1,212-269-4879   1200     NY fido node 107/34
  756. amy bbs          1,303-693-4735   1200     CO
  757. amy palace       1,201-446-1424   1200     NJ
  758. casa mi amy      1,904-733-4515   1200     FL
  759. connection       1,615-868-7860   1200     TN
  760. dragon           1,402-291-8053   1200     NE rpg board
  761. FAUG             1,415-595-5452   1200     CA
  762. guest            1,618-378-2133   1200     IL "Username:GUEST"
  763. micro systems    1,305-737-1590   1200     micro systems
  764. developer exch   1,408-372-1722   1200     maxi corp
  765. amigaboard       1,513-898-0702   1200     OH
  766. technisoft       1,801-264-8290   1200     UT fido, mostly MS-DOS
  767. vivid xpres      1,714-493-6094    300     CA
  768.  
  769.